---
title: Customizing Theme 

description: Customizing the theme in gluestack-ui v2 involves defining a theme configuration and applying it using GluestackUIProvider, enabling you to style your application's visual elements according to your design preferences.

showHeader: true
---

import { Canvas, Meta, Story } from '@storybook/addon-docs';
import { CollapsibleCode } from '@gluestack/design-system';

<Meta title="with-nativewind/Home/Theme Configuration/Customizing Theme" />


## Customizing Tokens

gluestack-ui v2, seamlessly accommodates the default Tailwind CSS [theme](https://tailwindcss.com/docs/theme), allowing users to effortlessly expand and customize it to suit their needs.

gluestack-ui v2 also ships with a set of handpicked default color palette tokens which are mapped separately with each mode. For example, the default color palette for light mode is `light` and the default color palette for dark mode is `dark`.

To customize tokens, follow these steps:

1. Go to `gluestack-ui-provider/config.ts` file. Update or add new tokens as per your requirements.

<CollapsibleCode>

```jsx
export const config = {
  light: vars({

    ... // other tokens
    //updated '--color-primary-0' value
    '--color-primary-0': '#C0C0C0',

    /* Added a new background color for light mode */
    '--color-background-new': '#BAE7FC',

  }),
  dark: vars({
     ... // other tokens
      /* Added a new background color for dark mode */
    '--color-background-new': '#89D6FA',
  }),
};

```
</CollapsibleCode>

2. In case you are adding a new color in your config file, you need to update it in the tailwind.config.js file as well.


```jsx
 theme: {
    extend: {
      colors: {
        background: {
          ... // other color values,
          /* Added a new background color */
          new: 'var(--color-background-new)',
        },
      },
    },
    plugins: [],
  },
```

You can customize all the tokens in `config`. For a complete list of tokens and default values, please check [default Tokens](https://gluestack.io/ui/nativewind/docs/theme-configuration/default-tokens).

By utilizing this approach, you can seamlessly modify the primary color tokens of the theme while maintaining the overall theme configuration intact.

If you want to extend the default tailwind config and add fonts, breakpoints, border radius values, and more, please refer to the [tailwindcss](https://tailwindcss.com/docs/theme#customizing-the-default-theme) documentation.